home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / apps / 315 / install.doc < prev    next >
Text File  |  1989-08-04  |  12KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.                             /////////////////////////////
  6.                             ///   Opus Installation   ///
  7.                             /////////////////////////////
  8.  
  9.  
  10.                If you read nothing else, please read this document 
  11.           completely! 
  12.  
  13.                Opus requires a one-megabyte ST. In addition, GDOS or G+Plus, 
  14.           printer drivers, and fonts are needed to use the charting 
  15.           facility, meaning you already possess a GDOS application, such as 
  16.           Easy-Draw, Publisher ST, Microsoft Write, or WordUp, among others. 
  17.           If GDOS isn't installed, you will be able to use the spreadsheet 
  18.           but unable to chart; to print charts from Opus, the GDOS files 
  19.           must be available in the directory specified in ASSIGN.SYS. These 
  20.           files include the screen and printer fonts, the printer driver, 
  21.           and the META.SYS file. Suggested setups for various disk drive 
  22.           configurations follow.
  23.  
  24.                A. 1 double-sided drive
  25.  
  26.                     1. Boot Disk
  27.                          AUTO folder: GDOS.PRG
  28.                          ASSIGN.SYS (taken from other application)
  29.                          GDOS screen fonts
  30.                          GDOS printer fonts, printer driver
  31.                          META.SYS
  32.  
  33.                     2. Opus disk- all files except screen fonts must reside 
  34.                          in the same directory!
  35.  
  36.                          GDOS screen fonts
  37.  
  38.                          OPUS.PRG
  39.                          OPUSMONO.RSC and/or OPUSCOLR.RSC
  40.                          OPUS.CNF
  41.                          PRINTER.INF (you may rename EPSON.INF or 
  42.                               DESKJET.INF to PRINTER.INF, provided you are 
  43.                               using an Epson-compatible or Hewlett Packard 
  44.                               Deskjet printer)
  45.                          OPUS.WID (printer font widths file- more on this 
  46.                               later)
  47.  
  48.                     The general procedure for running Opus would be:
  49.                          1. boot with disk 1,
  50.                          2. load Opus from disk 2,
  51.                          3. use disk 1 whenever you want to print a chart 
  52.                             from within Opus.
  53.                     Other disks may be used to store files, as they will 
  54.                     obviously have more space.
  55.  
  56.                B. 2 floppy drives
  57.  
  58.                     1. Drive A: Contents of A.1 above
  59.                     2. Drive B: Contents of A.2 above, WITHOUT the screen 
  60.                          fonts
  61.                     3. Work Disk: Place in drive B:. Leave disk A with all 
  62.                          the GDOS files in place for printing charts.
  63.  
  64.  
  65.  
  66.  
  67.  
  68.           March 12, 1989                                   Opus Installation
  69.  
  70.  
  71.                C. Hard drive
  72.  
  73.                     1. Place the contents of A.2, LESS the screen fonts, 
  74.                          wherever you see fit.
  75.  
  76.           For all configurations, please remember to have your "PATH=" line 
  77.           in ASSIGN.SYS point to the drive and directory containing the GDOS 
  78.           files. This line should be the first line of ASSIGN.SYS and has 
  79.           the form PATH=A:\GEMSYS if GDOS files are located in a GEMSYS 
  80.           folder on drive A:.
  81.  
  82.           Also remember you can print charts from OutChart.
  83.  
  84.           Now that you have your disks set up, you need to follow the 
  85.           following two-step procedure to create the file OPUS.WID, which 
  86.           provides a table of GDOS printer font widths so that Opus may 
  87.           provide truly accurate screen displays of charts. Make sure you 
  88.           first boot with GDOS or G+Plus present!
  89.  
  90.                Step 1: Running "The Assigner"
  91.  
  92.                     In order to provide screen displays that are 
  93.                     representative of the final printer output, Opus 
  94.                     requires you to have a 1:1 correspondence between screen 
  95.                     and printer fonts. Some programs, most notably          
  96.                     Publisher ST, specify screen fonts without corresponding 
  97.                     printer fonts (and vice versa) in the ASSIGN.SYS file, 
  98.                     the file which tells GDOS which fonts and device drivers 
  99.                     are available. Since it's a lot easier to modify an 
  100.                     existing ASSIGN file than create one from scratch, I've 
  101.                     written "The Assigner," a program that takes an existing 
  102.                     ASSIGN file and creates a new one that adheres to this 
  103.                     (I think) good rule. So go ahead and run ASSIGNER.PRG, 
  104.                     following the prompts, to create your new ASSIGN file. 
  105.                     If you have G+Plus, you can create a file "OPUS.SYS" and 
  106.                     install Opus as an application. If you have Atari's 
  107.                     GDOS, you will have to delete the original ASSIGN.SYS 
  108.                     and rename the new one to ASSIGN.SYS, and then reboot 
  109.                     your computer so the new ASSIGN file will take effect.
  110.  
  111.                     One other thing: Opus requires ASCII characters 32-126 
  112.                     to be present in all fonts used, since these are the 
  113.                     characters you can access from the standard keyboard. 
  114.                     Some fonts don't contain all of these characters, such 
  115.                     as the Publisher ST "Bullets" and "Drury Lane Caps" 
  116.                     fonts, and trying to print characters that don't exist 
  117.                     can crash the system. Should the Assigner encounter 
  118.                     these two fonts, it will not include them in the ASSIGN 
  119.                     file it creates.
  120.  
  121.                Step 2: Running FONTWID.PRG
  122.  
  123.                     This program shares name and purpose with the Publisher 
  124.                     ST program and is needed because GDOS screen and printer 
  125.                     fonts can have very different character widths. In 
  126.                     general, screen fonts are wider than printer fonts, and 
  127.                     this becomes really significant if you want to create 
  128.                     text centered in a box. If you base the box dimensions 
  129.  
  130.  
  131.                                         - 2 -
  132.  
  133.  
  134.           March 12, 1989                                   Opus Installation
  135.  
  136.  
  137.                     on the screen font widths, the box will be too large on 
  138.                     the printer.
  139.  
  140.                     Before running FONTWID, make sure the new ASSIGN file is 
  141.                     in effect, either by loading it from G+Plus or rebooting 
  142.                     the system with Atari GDOS. FONTWID will load the 
  143.                     printer driver and printer fonts, and create a file 
  144.                     called OPUS.WID. Make sure OPUS.WID is in the same 
  145.                     directory as OPUS.PRG, which will be the case provided 
  146.                     you ran FONTWID from this directory. You will then be 
  147.                     ready to run Opus.
  148.  
  149.                     FONTWID will also tell you how much free RAM you will 
  150.                     need to print charts from within Opus. To see that you 
  151.                     in fact have this much free RAM while in Opus, before 
  152.                     entering any data into the worksheet, select 
  153.                     "Statistics" from the worksheet "Options" menu item, and 
  154.                     compare the amount of memory given under "System Memory" 
  155.                     with that reported by FONTWID. If you don't have enough 
  156.                     free RAM, you will have to remove desk accessories or 
  157.                     memory-hungry AUTO folder programs (like RAMdisks) or 
  158.                     remove some fonts from your ASSIGN file, and repeat the 
  159.                     process just described.
  160.  
  161.                     Finally, FONTWID will produce an error message should it 
  162.                     load a printer font that doesn't at least contain ASCII 
  163.                     characters 32-126. The Assigner accounts for the 
  164.                     Publisher ST fonts that fail this test, but there may be 
  165.                     others. Should you encounter one, you will have to 
  166.                     remove it from your ASSIGN.SYS file (I personally 
  167.                     haven't seen any others).
  168.  
  169.           Whew! No one said GDOS was easy to work with, but I think the 
  170.           Assigner and FONTWID automate the process of installing Opus to 
  171.           the extent that it's reasonably painless. If you run Opus and it 
  172.           tells you "screen and printer fonts don't match- charting 
  173.           disallowed" or something similar, double-check your installation 
  174.           and try again. If all else fails, leave me E-Mail on GEnie or 
  175.           Compuserve, or check the Opus section in Category 2 of the GEnie 
  176.           ST message base.
  177.  
  178.           For those of you that have delved into the mystery of ASSIGN files 
  179.           and GDOS, let me mention a couple of things. There's no problem 
  180.           with using a single ASSIGN file for medium and high resolution. 
  181.           The Assigner will first fix up medium and high rez fonts, then fix 
  182.           up the printer and medium rez fonts, and finally go back and fix 
  183.           up the medium and high rez fonts, so that there's a "1:1:1" 
  184.           correspondence between all three font groups. Only a single 
  185.           OPUS.WID file is needed here; separate OPUS.WID files are needed 
  186.           if you're using two different printers or ASSIGN files where you 
  187.           want different printer fonts for different projects. Finally, let 
  188.           me note that the Assigner assumes a couple of things. First, fonts 
  189.           must conform to the standard file name format: two characters 
  190.           serving as a font identifier (such as "SS" for Swiss) followed by 
  191.           a two-digit size indicator. Second, the printer driver must be 
  192.           listed as device 21 (i.e. 21 printer.sys or 21 hpdsk150.sys, for 
  193.           example). Opus also requires the printer driver to be listed as 
  194.           device 21. The line "31 meta.sys" *absolutely must* be present in 
  195.  
  196.  
  197.                                         - 3 -
  198.  
  199.  
  200.           March 12, 1989                                   Opus Installation
  201.  
  202.  
  203.           the ASSIGN file, else you will be unable to print charts or save 
  204.           them as metafiles (this shouldn't be a problem, as all ASSIGN 
  205.           files I've seen include this line).
  206.  
  207.  
  208.           Using PRINTDEF.PRG
  209.  
  210.           If you have an Epson-compatible printer or a Deskjet, rename 
  211.           EPSON.INF or DESKJET.INF to PRINTER.INF and store it in your Opus 
  212.           directory. If not, you will have to run PRINTDEF.PRG to create a 
  213.           PRINTER.INF file. This file contains the control codes for various 
  214.           text effects, such as bold, underlined, condensed, etc. This means 
  215.           you'll have to dig up your printer manual, look up the codes, and 
  216.           input them into the PRINTDEF dialog. Be sure to use the decimal 
  217.           codes, and separate them by spaces. Opus uses PRINTER.INF to print 
  218.           worksheets, and PRINTER.INF has nothing at all to do with chart 
  219.           printing.
  220.  
  221.  
  222.  
  223.           Remember, if you have any problems installing Opus, leave me a 
  224.           note in any of the following places:
  225.  
  226.                1. Opus Topic in Category 2 of GEnie ST message base
  227.                2. GEnie E-Mail (send to D.S.HARRISON)
  228.                3. Compuserve (ID 72277,2315)
  229.  
  230.           Good luck, and I hope you enjoy my program!
  231.  
  232.                Doug Harrison
  233.                3/8/89
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                         - 4 -
  264.  
  265.